Zira Botのコマンド一覧
Ziraのコマンド一覧はz/helpコマンドで確認することができる。 (2021年9月16日時点でのコマンド)
ロールを付与するリアクションを追加・削除するコマンド
https://scrapbox.io/files/61430319fcbe7e002359c2be.png
※下のお肉の絵文字がリアクション。
z/channel <#チャンネル名>
コマンドを実行するチャンネルを指定します。
z/message <メッセージID>
編集するメッセージを指定して次回以降のコマンドの対象にします。
他人のメッセージを対象にすることもできます。
z/message <メッセージ内容>
メッセージを送信します。
z/embed (埋め込むJSON)
埋め込みメッセージを作成し、そのメッセージを次回以降のコマンドの対象にします。
埋め込みメッセージを作るときはこのサイトが便利。
コマンドの例
code:example-embed.json
https://scrapbox.io/files/6143bee1a68e4a001d69e243.png
z/edit <メッセージID> <新しいメッセージ文章>
メッセージの文章を書き替えます。
Zira自身が送信したメッセージにしか実行できません。
z/normal <絵文字> <ロールID>
ロールを付与するリアクションを作成します。
リアクションは押すたびにロールがついたり外れたりします。
z/once <絵文字> <ロールID>
ロールを付与するリアクションを作成します。
リアクションを押すことでロールが付与されますが、再び押しても外すことはできません。
z/remove <絵文字> <ロールID>
ロールを剥奪するリアクションを作成します。
z/onceコマンドの逆。
z/toggle <emoji> <role>
ロールを付与するリアクションを作成します。
このコマンドで、1つのメッセージに対して複数のリアクションを追加しても、どれか1つしか選べません。
選択したリアクションをもう一度押すことでロールを外すことができます。
z/list
リアクション追加系コマンドで追加した設定の一覧を表示します。
z/delete
リアクション追加系コマンドで追加した設定を削除するコマンド。
単体で実行すると、このコマンドのオプションを表示します。
z/delete check
削除されたロールに対する設定が残っていないかチェックします。
設定が残ってたら自動的に削除します。
z/delete <メッセージID> <ロール名またはロールメンション>
リアクションについたロール変更の設定を削除します。
z/delete all <メッセージID>
指定したメッセージへのリアクションについたロール変更の設定をすべて削除します。
ユーザーの行動に合わせて自動でロールを付与するコマンド
z/autorole
サーバーに参加した人に対して自動的にロールを付与する設定を行うコマンド。
単体で実行すると、このコマンドのオプションを表示します。
z/autorole user <ロール名またはロールメンション>
ユーザー(人間)がサーバーに参加したときに自動的にロールを付与するように設定をします。
設定を解除するときはもう一度同じコマンドを実行してください。
z/autorole bot <ロール名またはロールメンション>
Botがサーバーに参加したときに自動的にロールを付与するように設定をします。
設定を解除するときはもう一度同じコマンドを実行してください。
z/autorole show
z/autoroleコマンドで追加した設定の一覧を表示します。
z/timed
このコマンドのオプションを表示します。
z/timed add <有効時間> <ロール名またはロールメンション>
サーバーに参加後自動的にロールを付与します。
ロールは有効時間の間だけ付与されます。
有効期限は最大7日間まで設定可能です(Premium除く)。
例: 30分間だけロールを付与する場合
z/timed add 30m @ロール
有効時間は以下の単位を使用できます。
table:timed-time
表記 意味
d, day, days ~日
h, hour, hours ~時間
m, minute, minutes ~分
z/timed remove <ロール名またはロールメンション>
z/timed addコマンドによる設定を削除します。
z/voice
ボイスチャンネルに参加している人に自動的にロールを付与する設定をするコマンド。
単体で実行すると、このコマンドのオプションを表示します。
z/voice add <チャンネルID> <ロール名またはロールメンション>
ボイスチャンネルに参加したときに付与するロールを増やします。
z/voice remove <チャンネルID> <ロール名またはロールメンション>
z/voice addによるロール設定を削除します。
z/voice show
z/voice addによるロール設定の一覧を表示します。
履歴を残すコマンド
z/log <#チャンネル名>
Ziraによるロール変更の履歴を書き込むチャンネルを設定します。
z/log disable
ロール変更の履歴の書き込みを停止します。
z/dm Premiumのみ
ロールを設定したリアクションを押すたびにユーザーにDMを送信します。
z/join
サーバーに参加したときにメッセージを送信するコマンド。
単体で実行すると、このコマンドのオプションを表示します。
z/join channel <#チャンネル名>
参加メッセージを送信するチャンネルを指定します。
z/join disable
参加メッセージを無効化します。
z/join add text <メッセージ>
参加した時のメッセージを追加します。
<メッセージ>内では以下の文字列は自動的に置換されます。
table:join-add--placeholders
置換前 置換後の内容
$user$ 参加者名
$discriminator$ 参加者のIDの後ろにある4桁の数字
$id$ 参加者のID
$mention$ 参加者へのメンション
$guild$ サーバー(guild)名
$membercount$ サーバー参加者のカウント
z/join add embed <JSON>
参加した時にJSONで埋め込みメッセージを送信できます。
それ以外はz/join add textと同様です。
z/join list
z/join addで設定したメッセージの一覧を確認できます。
メッセージの内容とそれに紐づけられたIDが表示されます。
z/join remove <リスト内ID>
z/join addで設定したメッセージを削除します。
IDはz/join listで確認してください。
z/leave
サーバーから脱退したときにメッセージを表示します。
単体で実行すると、このコマンドのオプションを表示します。
オプションの種類と内容はz/joinコマンドと同様です。
提案コマンド
z/suggestion
このコマンドのオプションを表示します。
z/suggestion new <#チャンネル名またはdisable>
提案システムの履歴の送信先を指定します。
disableで無効化します。
z/suggestion approved <#チャンネル名またはdisable>
z/approveコマンドで承認された投稿の送信先を指定します。
disableで無効化します。
z/suggestion denied <#チャンネル名またはdisable>
z/denyコマンドで拒否された投稿の送信先を指定します。
disableで無効化します。
z/suggestion invalid <#チャンネル名またはdisable>
z/invalidコマンドで無効・スパムとされた投稿の送信先を指定します。
disableで無効化します。
これはモデレーター専用チャンネルに設定することが推奨されています。
z/suggestion potential <#チャンネル名またはdisable>
z/maybeコマンドで保留にされた投稿の送信先を指定します。
disableで無効化します。
z/suggestion role <ロール名またはロールメンションまたはdisable>
z/suggestion approvedなどの提案のステータス変更コマンドを使用できるロールを設定します。
ここで設定したロール以外はステータス変更コマンドを使用できなくなります。
z/suggestion role disableで設定を無効化します。
z/suggestion submit <#チャンネル名またはdisable> Premiumのみ
指定したチャンネルでのみz/suggestを使用できるようにします。
disableで全てのチャンネルにて受け付けるようになります(デフォルト)。
z/suggestion dm Premiumのみ
投稿した提案のステータスが変更されたとき、DMで通知を受け取るかどうかを切り替えます。
z/suggestion reaction Premiumのみ
新しく提案が投稿されたときに自動的に2つのリアクションをつけるように設定します。
ユーザーからの投票などに役立ちます。
リアクションに設定する絵文字はz/suggestion emojisコマンドで設定できます。
https://scrapbox.io/files/6143cd02d59a370023f9fcc1.png
z/suggestion emojis <絵文字1> <絵文字2> Premiumのみ
z/suggestion reactionコマンドで使う絵文字を設定します。
必ず2つ設定してください。
z/suggestion move <ID> <#channel> Premiumのみ
提案を別のチャンネルへ手動で移動します。
IDはSuggestion IDかメッセージIDのどちらかを指定可能です。
z/suggestion cooldown <分またはdisable> Premiumのみ
提案を再度投稿するまでの待ち時間を分単位で設定します。
z/suggestion cooldown disableで待ち時間なしに投稿できるようになります。
z/suggestion autosubmit <#チャンネル名またはdisable> Premiumのみ
submitコマンドを実行するチャンネルを指定します(たぶん)。
z/suggestion autosubmit disableで無効化します。
公式ドキュメントに記述がないので詳細は不明。
z/suggest <投稿する文章>
z/suggestion newに設定したチャンネルに提案を投稿できます。
z/submitでも同様のことができます。
z/approve <ID> (理由)
提案を承認します。
IDはSuggestion IDかメッセージIDのどちらかを指定可能(以降の提案コマンドでも同様)。
z/suggestion approvedが設定されている場合はそのチャンネルに投稿が移動します。
z/deny <ID> (理由)
提案を拒否します。
z/suggestion deniedが設定されている場合はそのチャンネルに投稿が移動します。
z/maybe <ID> (理由)
提案を保留にします。
z/suggestion potentialが設定されている場合はそのチャンネルに投稿が移動します。
z/invalid <ID> (理由)
提案を無効またはスパムとします。
z/suggestion invalidが設定されている場合はそのチャンネルに投稿が移動します。
その他・未分類
z/config
サーバー内での設定を変更するコマンド。
単体で実行すると、このコマンドのオプションを表示します。
z/config prefix <接頭辞>
Ziraのコマンドを実行するときの接頭辞を設定します。
このコマンドでz/接頭辞を使えないようにすることはできません。
z/config role <ロール名またはロールメンションまたはdisable>
Ziraのコマンドの実行を許可するロールを設定します。
ここで設定したロールがつけられてない人はコマンドを実行できなくなります。
z/config role disableでこの設定を無効化します。
z/rooms
ユーザーがプライベートなボイスチャンネルを作成することができるようにします。
z/colors
色がついたロールを新規作成します。
作成されるロールは以下の8種類。
https://scrapbox.io/files/6143c8dad131cf0020c8a122.png
このコマンドはロールを作成するだけなので、誰でも使えるようにするにはリアクション追加系コマンドで適切に設定する必要があります。
z/premium
加入していない場合、加入するためのリンクも表示されます。
現在使用不可
z/config language <言語コード>
翻訳プラットフォームを移行中のため現在使用不可。
z/trello